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Introduction 


Installation 


CHAPTER 1 

INTRODUCTION AND INSTALLATION 


The X-25/HDLC C Simulator package is an optional package 
which provides the following: 

• Enhanced automatic HDLC simulator and HDLC library 
which enables you to access the simulator. This library 
provides a number of features not available in the 
standard HDLC library which comes with the C 
Development System. 

• Automatic X.25 simulator and X.25 library which enables 
you to interact with the simulator. 

In order to use this package, you must have the C 
Development System installed on your Chameleon 32. 


To install the X.25/HDLC Simulation package on your 

Chameleon, do the following: 

t. Turn on the Chameleon 32 and insert the disk labeled 
The Installer (930-3001-01) into the floppy disk drive. 

2. When the first screen appears, the Chameleon 32 will 
automatically boot from the floppy drive. 

3. A prompt appears which asks whether or not you want to 
format the. hard disk. Press n (no) in response to this 
prompt. 

4. A menu appears with three options, as follows: 

FI Install, which displays the installation menu. 

F2 Show Installation Status, which displays the 
software packages that have been installed, and 
their version numbers. 

F3 Identify Installation Disk, which displays the title 
and version number of any installation disk in the 
floppy drive. 
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Introduction & installation 


Customer 

Support 


5. Remove The Installer from the floppy disk drive and 
press FI Install. The screen will display: 

Insert Disk #1 of package to be installed and press RETURN 


6. Insert the X.25/HDLC Simulator disk into the drive and 
press Return. The installation will proceed immediately 
and the screen will display: 

Installing package name Disk 1 of x. 

When the installation of the disk is complete, the Install 
Menu will be redisplayed. 


7. You can then reset the Chameleon and use the new 
software. 


If you have any problems installing software, please call 
Tekelec Customer Support at 1-800-441-9990. In 
California, call 1-818-880-5656. 
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Description 


Note: 


CHAPTER 2 

ENHANCED AUTO HDLC SIMULATOR 


The Enhanced Auto HDLC Simulation C Library is called 
iibhdlci.a and is located in the Mib directory. The Auto HDLC 
functions are listed on the next page so that you can locate 
them quickly within this section. Following the index, the 
functions are in alphabetical order with one function per page. 

This version of the HDLC library is backward compatible with 
the standard C HDLC library. This means that you can use 
your existing HDLC simulation programs by relinking the 
applications with the Enhanced HDLC library. 

The Enhanced HDLC library provides you with the ability to 
transmit and receive, packets up to 8 Kbytes in length. This is 
substantially larger than the maximum packet size of 512 bytes 
which is allowed in the standard HDLC library. The Enhanced 
HDLC library also provides some extra functionality for greater 
testing capability. For example, you can transmit packets with 
illegal sequence numbers, frame types, and frame lengths. 
You can also turn the protocol timers on and off. . 

This, library runs on the same processor as the application, 
which causes packet transmission to be slower than with the 
standard HDLC library. This version of HDLC is therefore not 
suitable for load generation or time critical applications. 

The Enhanced Auto HDLC library functions is illustrated below: 



} 


} 


Application Process 


HDLC Process 
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Enhanced HDLC 

Functions The Enhanced HDLC Library functions are described on the 

following pages: 

Function Description Page 


flush Clears the reception buffer 2-4 

getport Returns port communicating with library 2-5 

hdlc data_trans Specifies how received i-frames are handled 2-6 

hdlc setack Determines whether 1-frames are acknowledged .... 2-7 

hdlc set mod Sets the HDLC modulo 2-8 

hdlc_setpri Sets the priority of the HDLC process 2-9 

hdlc_set_t2 Sets the value of the T2 timer '. 2-10 

hdlc setup Sets values of all HDLC parameters 2-11 

hdlc transmitFrame Transmits an HDLC frame 2-12 

hdlc transmitMode Transmits an l-frame 2-15 

hdlc transmittrp Transmits an unformatted string . 2-16 

initpl Initializes the Front End Processor 2-17 

pi reset Restarts or stops the simulator 2-18 

receive Receives an l-frame .' 2-19 

receivewait Waits to receive an l-frame ’ . . . . 2-20 

set nl Sets the value of N1 2-21 

set n2 Sets the value of N2 2-22 

setport Selects a Chameleon port 2-23 

set_t1 Sets the value of the Tl timer 2-24 

set window Sets the HDLC window size 2-25 

slof Disestablishes the link 2-26 

slon Attempts to establish the link 2-27 

status Returns the frame level status 2-28 

transmit Transmits an l-frame 2-29 
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Default 

HDLC Values The table below lists the default values for the Enhanced 

HDLC simulator. The HDLC protocol parameter values can be 

set using the hdlc setup() function when the simulator is 

initialized and can be changed individually using the functions 
indicated in the table below. 


ITEM 

DEFAULT VALUE 

FUNCTION 

Acknowledgement 

ON 

HDLC SETACK 

K (window size) 

7 

SET_WlNDOW 

Modulo 

8 

HDLC SET__MOD 

N1 

2000 bytes 

SET N1 

N2 

10 

SET N2 

Port 

Port A 

SETPORT 

Process Priority 

10 

HDLC SETPRI 

T1 

2.5 sec 

SET_T1 

T2 

0.05 sec 

HDLC SET T2 


Default HDLC Values 
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FLUSH 


Declaration 

Description 


void f!ush() 

This function clears all outstanding 1-frames in the reception 
buffer. 
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GETPORT 


Declaration int getportQ 


Description This function returns which port is currently communicating 

with the library. Use the setport function to select the port. 
The default is Port A. 


Returns 


0 Port A selected 

1 Port B selected 
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HDLC DATA 


Declaration 


Range 


Description 


Returns 


TRANS 


intr hdlc data__trans (type) 

int type; 


type 0 ABSORB 

1 ECHO 

2 NORM 


This function specifies how !-frames are to be handled once 
received by HDLC. 

ABSORB configures HDLC to discard all received !-frames 
(they are, however, acknowledged), 

ECHO configures HDLC to retransmit air received 1-frames. 

NORM selects the default mode where l-frames are delivered 
to the application. 


0 Successful 
-1 Parameter error 
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HDLC SETACK 


Declaration 


Range 


int hdlc__setAck (val) 

char val; 


val: ■ 0 ON 

1 OFF 


Description 

Returns 


This function turns the acknowledgement of 1-frames on or off. 

0 Successful 

-1 Parameter error 
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HDLC SET 


Declaration 


Range 


Description 


Returns 


MOD 


int hdlc set mod (val) 

int val; 


val: 1 Modulo 8 

2 Modulo 128 

3 Interim Modulo 128. This conforms to the 
interim Modulo 128 standard, in which 
unnumbered frames consist of two bytes, with 
the second byte being zero, except for the P/F 
bit 


This function sets the modulo of communication for HDLC. 
The default mode is Modulo 8. 


0 Successful 
-1 Parameter Error 
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HDLC SETPRI 


Declaration 


hdlc_setpri (priority) 
unsigned char priority; 


Range 


priority 0 - 255 (255 = highest priority) 


Description This function sets the priority of the HDLC process. The 

priority can be changed for optimum speed performance 
depending on whether the HDLC process is mainly 
transmitting or receiving. If optimum performance is not 
required, this function need not be called. 

The default priority is 10. Programs started from the C shell 
have priority 200. 

Note If this function is used, it must be called before initpIQ. 


Returns 0 


Successful 
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HDLC SET 


Declaration 


Range 


Description 


Returns 


T2 


int hdlc_sel t2 (val) 

int val; 


0 - 255 .01 second units 

-1 Timer not used 


This function sets the value of the frame acknowledgement 
timer T2. in units of .01 seconds. If -1 is specified, the timer 
value is not used. 


0 Successful 

-1 Parameter error 
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HDLC SETUP 


Declaration int hdlc_setup (n1,n2,t1,t2,k,mode) 

int nl; 
int n2; 
int tl; 
int t2; 
int k; 
int mode; 


Range 


nl Size of HDLC frame in the range 1 - 8200 bytes 

n2 Number of retransmissions in the range 1 - 255 

tl Retransmission timer in the range 1 - 255 in .01 

second units. A value of -1 turns use of the timer 
off. 

t2 Acknowledgement timer in the range 1 - 255 in .01 

second units. A value of -1 turns use of the timer 
off. 

k Window size. For Mod 8, the range is 1 - 7. For 

Mod 128, the range is 1 - 127. 

mode Modulus of operation: 

1 = Mod 8 

2 = Mod 1.28 

3 = Mod 128 Interim 


Description This function sets up of the HDLC system parameters using 

one function. Each of the parameters can be set separately 
as indicated in the table on page 2-2. 


Returns 0 Successful 

-1 Parameter error 
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HDLC TRANSM1TFRAME 




Declaration 

int hdlc transmitFrame (type, p f, c r, e, mode, rFrame) 

unsignecTchar type; 

unsigned char p f; 

unsigned char c r; 

unsigned char ef7; 

int mode; 

unsigned char rFrame; 

Description 

This function transmits the specified frame type in the 
specified mode. The link need not be established, to transmit 
frames with this function. 


Note that the parameters e and rFrame are relevant only when 
transmitting a frame reject. 


type Specifies the type of frame being transmitted: 

0x01 1 RR 
0x02. I RNR 
0x03 l — REJ 
0x04 I SABM 
0x05 I SABME 
0x06 I — DISC 
0x07 I FRMR 
0x08 l — UA 
0x09 l — DM 


p f: Sets, the Poil/Final bit on or off: 

0x00 PF ON 
0x01 PF~ OFF 


c r: Sets the Command/Response bit on or off: 

0x00 CR OFF 
0x01 CR ON 
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e[5] This parameter is relevant only when transmitting a 
rejected frame: 


e[0]: 

0x00 

CR0 

Sets the C/R bit to 0 

0x01 

CR1 

Sets the C/R bit to 1 

e[ 1 ]: 

0x00 

WO 

Sets the W bit to 0 

0x01 

W1 

Sets the W bit to 1 

e[2]: 

0x00 

XO 

Sets the X bit to 0 

0x01 

XI 

Sets the X bit to 1 

e[3j: 

0x00 

Y0 

Sets the Y bit to 0 

0x01 

Y1 

Sets the Y bit to 1 

e[4]: 

0x00 

ZO 

Sets the Z bit to 0 

0x01 

Z1 

Sets the Z bit to T 


mode: ' Specifies the mode of transmission for the frame: 


0 

GOOD CRC 

Transmit with a good CRC 

3 

NR GT 

Transmit with an N(r) sequence 
number greater than expected 

4 

NR_LT 

Transmit with an N(r) sequence 
number less than expected 

5 

NS_GT 

Transmit with an N(s) sequence 
number greater than expected 

6 

NS LT 

Transmit with an N(s) sequence 
number less than expected 

7 

TOO_SHORT 

Transmit too short a frame 

8 

TOO LONG 

Transmit too long a frame 


rFrame: This parameter is relevant only when transmitting a 

rejected frame. It specifies the type of rejected 
frame to transmit: 

0x00 C i 
0x01 C~ RR 
0x05 C RNR 
0x09 C“REJ 

0x2F C SABM 
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0x6 F C SABME 
0x43 C DISC 
0x87 C FRMR 
0x63 C UA 
OxDF C DM 


The valid error codes for a specific message type are 
described in the following diagram: 


FRAME 

GOOD 

BAD 

CRC 

ABORT 

NR GT 

NR LT 

NS GT 

NS LT 

TOO 

LONG 

TOO 

SHORT 

1 RR 


X 

X 



X 

X 



! REJ 


X 

X 



X 

X 



l RNR 


X 

X 



X 

X 



1 SABM 


X 

X 

X 

X 

X 

X 



l_SABME 


X 

X 

X 

X 

X 

X 



1 DISC 


X 

X 

mm 

X 

X 

X 



1 FRMR 


X 

X 

X 

X 

X 

X 



1 UA 


mm 

X 

X 

X 

X 

X 



1 DM 


X 

1 X 

X 

X 

X 

X 




X = NOT RELEVANT MODES 


Returns 


-1 Parameter error 

0 Successful 

1 Front End Processor busy (transmitting previous 
packet) 

2 initpl not performed 
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HDLC TRANSM1TMODE 


Declaration 


Range 


#include <hdlc.h> 

int hdlc transmitMode (buffer, length, mode) 

char ‘buffer; 

int- length; 

int mode; 


buffer: Pointer to the buffer containing the data to transmit 

length: Number of bytes to transmit 

mode: 0 GOOD_CRC 

1 BAD CRC 

2 ABORT SEQ 


Description This function sends an !-frame using the specified mode. 

When the selected, mode is GQOD_CRC, this function is 
equivalent to transmitQ. 


Returns 


0 Successful 

1 Front End Processor is busy 

2 Initpl not performed 

3 Link not established 

-1 Parameter error 
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HDLC TRANSMITTRP 


Declaration 


int 

char 

int 

int 


hdlc transmitTrp (buffer, length, mode) 

"buffer; 

length; 

mode; 


Range 


buffer: Pointer to the buffer containing the data to transmit 

length: Number of bytes to transmit 

mode: 0 GOOD_CRC 

1 BAD CRC 

2 ABORT SEQ 


Description 


This function sends an unformatted string on the line 
transparently to HDLC. 


Returns 


0 Successful 

1 Parameter error 
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1NITP1 


Declaration 


Range 


Description 


Returns 


int initpl (typel , type2, encode, bitrate) 

char typel; 

char type2; 

char encode; 

unsigned long bitrate; 


typel 

0 

DCE 

1 

DTE 


2 

ISDN 

type2 

0 

Network 

1 

Subscriber 

encode 

0 

NRZ 


1 

NRZ1 

bitrate 

50 

- 64000 


This function starts the HDLC process and initializes the port 
specified by setportQ. 


0 Successful 
-1 Parameter error 
-2 HDLC executable code not found 
-3 Port already initialized 
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PI RESET 


Declaration 


Range 


Description 


Returns 


int ptreset(kind) 
char kind; 


kind 0 Restart simulation 
1 Stop simulation 


This function either restarts the simulation or stops the 
simulation. The restart function brings HDLC to the same 
status (default values, etc.) as after an Initpl (). The stop 
function stops the simulation for the specified port and a new 
initpl () can be issued. If both ports are stopped, the HDLC 
process is removed. 


0 Successful 
. -t Parameter error 
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RECEIVE 

Declaration 


Description 


Returns 


int receive(packet) 
char. "packet; 


This function receives an 1-frame from the Front End 
Processor and places the 1-field frame starting at the address 
pointed to by the passed variable ^packet. 

The external global variable rxlen will be set to the length of 
the received frame. If rxlen = 0, then no 1-frame was received. 


0 Successful 

1 Link not established 

2 Initpl not performed 
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RECEIVEWAIT 


Declaration ^include <mtosux.h> 

int receiveWait (packet, waitTime) 
char “packet; 
unsigned long waitTime; 


Range 


packet: 


Pointer to receive buffer 


waitTime: 


Maximum time to wait for a message, in the 
following units (t is the number of units): 


SEC + t 
HMS + t 
TMS + t 
MS + t 


Seconds 
.1 seconds 
.01 seconds 
.001 seconds 


NOEND Wait forever 

1MONLY Attempt to receive one time oniy 


Description This function will wait for the reception of an l-frame. The time 

it will wait is specified by waitTime. The frame will be put in 
the buffer pointed out by packet. The global variable rxien will 
be set to the length of the received frame. 

If rxien = 0, then no i-frame was received. 


Returns 


0 Successful 

1 Link not established 

2 initpl not performed 

4 Timeout 
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SET N1 


Declaration 

int set nl(val) 
int val; 

Range 

val 1 - 8200 

Description 

This function sets the value of N1 (maximum size of a frame in 
bytes). The default value is 2000. 

Returns 

0 Successful 
-1 val outside of range 
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SET N2 

Declaration 

Range 

Description 

Returns 


int set n2(val) 

int val; 


val 1 - 255 


This function sets the value of N2 (the maximum number of 
retransmissions). The default value is 1 0. 


0 Successful 
-1 val outside of range 
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SETPORT 


Declaration 


Range 

Description 


Returns 


int setport(port) 
int port; 


port 0 Port A 
1 Port B 


This function sets the library to exchange information with 
either Port A or Port B. Use the getport function to determine 
which port is currently communicating with the library. 


0 Successful 
-t Parameter out of range 

-2 Attempted to select Port B on Chameleon with a single 
port (Port A) 
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SET T1 


Declaration 


Range 


Description 

Returns 


int set tl (val) 

int vai; 


val 1 - 255 .01 second units 

-1 Turns off use of timer 


This function sets the vaiue of the Tl frame level timer in .01 
second units. The default value is 255 {2.5 seconds). 


0 Successful 
■1 val outside of range 
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SET WINDOW 


Declaration 


int set window(val) 
char vaf; 


Range 


val 1-7 (Valid range for Modulo 8) 
1-127 (Valid range for Modulo 128) 


Description This function sets the window size for the frame level. The 

default value is 7. The modulus of operation (Mod 8 or Mod 
128) must be set before setting the window size. 


Returns 0 Successful 

-1 val outside of range 
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SLOF 


Declaration 

slofQ 

Description 

This function disconnects the link at the frame level by sending 
a DISCONNECT. Be sure to check the link status for the 


result of this command. 

Returns 

None 
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SLON 


Declaration 


Description 


Returns 


slonQ 


This function attempts to establish a link at the frame level by 
sending a SABM or SABME depending on the modulus of 
operation. Be sure to use STATUS to ascertain that the link is 
established before you use transmit() to transmit data. 


None 
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STATUS 


Declaration 


int statusQ 


Description 


This function returns a value indicating the status of the frame 
level. 


Returns 


0 Disconnected 

1 Link connection requested 

2 Frame reject state 

3 Link disconnection requested 

4 Information Transfer State 

5 Local Station Busy 

6 Remote Station busy 

7 Local and remote stations busy 
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TRANSMIT 


Declaration 


Description 


Returns 


transmit (packet, length) 
char ‘packet; 
int length; 


This function transmits an 1-frame with the l-field set to the 
number of bytes specified by the passed variable length, 
starting at the address pointed to by the passed pointer 
*packet. 


0 Successful 

1 Front End Processor busy (transmitting previous packet) 

2 initpl not performed 

3 Link not established 
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CHAPTER 3 
X.25 SIMULATOR 


Introduction 


The X.25 Simulator provides an automatic X.25 simulator and 
a library of protocol functions which enable a C application to 
access the simulator. The following features are supported: 

• Multiple Logical Channels. (The maximum number of 
LCNs is determined by available memory and the packet 
layer window size.) 

• SVCs and PVCs 

• CCITT X.25 or TRANSPAC X.25 

• Automatic handling of sequence numbering, flow control, 
and error recovery 

• Complete control over the following parameters: 

Called address 
Calling address 
User data 

Facilities (negotiating is not supported in this 
release) 

Cause 

Diagnostic 

. - Diagnostic explanation 
M-bit, D-bit and Q-bit 
Layer 2 parameters 

• Support of the following X.25 packet types: 

Call Request 
Clear Request 
Restart Request 
Reset Request 
Diagnostic Request 
Data Request 
Interrupt Request 
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Functions 


Include Files 
Note 


The X.25 library functions are defined in the libx25.a file 
located in the the \Jib directory. General instructions for using 
the X.25 library functions in a C program are provided on the 
following page. Each function is described fully on the pages 


indicated below. 

/ 

Function Description Page 


x25 CallAcc Accepts an incoming Call Request '3-9 

x25 CallReq Transmits a Call Request 3-11 

x25 ClearReq Transmits a Clear Request 3-13 

x25 DataReq Transmits a Data packet 3-14 

x25__DiagReq Transmits a Diagnostic packet 3-16 

x25_Getport Indicates the current port (A or B) 3-17 

x25 IntDataReq Transmits a Data Interrupt 3-18 

x25 LinkReq Sets the link on or off. . . . 3-19 

x25 Receive ’ Receives an incoming packet 3-20 

x25 ResetReq Transmits a Reset Request 3-29 

x25_RestartReq Transmits a Restart Request 3-30 

x25_Setport Selects a Chameleon port (A or B) 3-31 

x25. Start Starts the X.25 simulator 3-32 

x25 Stop Stops the X.25 simulator . . .' 3-36 


You must include the x25Iib.h file when using X.25 library 
functions. 

If your program also uses functions from libraries provided in 
the base Chameleon C Development system, you may need to 
include the cham.h file, which is provided with the base 
Chameleon C package, if so, in your program, include the 
cham.h file before you include the x25lib.h file to ensure that 
the appropriate constants and variables are used. In other 
words,, the include statements should be in the following order: 


■ 

#include cham.h 
#include x25lib.h 
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Description 


The X.25 functions provide access to the X.25 automatic 
simulator. Some of the functions must be used in a specific 
sequence in a program in order to establish a call and transfer 
data. This sequence is described below. 

Initializing the X.25 Simulator 

You must first initialize the X.25 simulator. To do this, your 
application must call two functions: 

• x25 SetportQ selects the Chameleon port on which to 
initialize the simulator 

• x25 Start{) initializes the X.25 simulator using the specified 
HDCC and X.25 parameters. These parameters include the 
X.25 standard (CCITT or TRANSPAC) and the number of 
PVCs and SVCs that the X.25 simulator will accommodate. 

For PVCs, Logical Channel Numbers (LCNs) are assigned 
automatically starting with the lowest LCN used for the 
selected X.25 standard: . 

- For CCITT X.25, PVCs are assigned LCNs beginning 
with LCN 1. 

- For TRANSPAC X.25, PVCs are assigned LCNs 
beginning with LCN 0. 

To initialize the X.25 simulator on both Ports A and B, you 
must call x25_Setport() and then x25_Start{) for each port. 

When initialization is successful (x25__Start returns 0), the 
simulator is started, the physical layer is set up, and HDLC is 
initialized. The next step is to establish an X.25 link between 
the Chameleon and the Device Under Test (DUT). 


Link Establishment 


The link can be established by either the Chameleon or by the 

DUT, using the following functions: 

• For the Chameleon to initiate link establishment, your 
application must cail the function x25 LinkReq() with the 
Type parameter specifying to set the !inj< ON. 

• For the Chameleon to wait for the DUT to initiate link 
establishment, your application must call the function 
x25_^_Receive(). (This is the function which is used to 
receive data from the DUT.) 
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When a packet is received, x25__Receive() sets the 
parameters ReqType (which identifies the packet type) and 
RetVal (return value). 

An incoming Call Request is indicated by the receipt of a 
Link Status (ReqType = aiLink) with a RetVal = 9 (Link is 
on) in response to the x25_Receive(). 

For PVCs, data transfer can then occur. For SVCs, a call 
must be established, as described below. 


Call Establishment 

For SVCs, a call can be established by either the Chameleon 

(outgoing cail) or by the DUT (incoming call). 

To establish an outgoing call, the following sequence must 

occur: 

• You application must cail the function x25_CallReq() which 
causes the simulator to transmit a Cali Request to the DUT. 
A call to this function must be made for each call you are 
trying to establish. x25_CailReq() includes a RefNo 
parameter which enables you to assign, a reference number 
to each call request. This enables you to match the 
assigned LCN to its corresponding Call Request. 

• Generally, there are two responses to each Call Request 
that you make. Your application must call x25_Receive to 
receive the first response to your cail request. The first 
response is from the X.25 simulator, and is generally an 
Assigned LCN (ReqType = aiCallLCN) which returns the 
Logical Channel Number assigned to the call. When the 
aiCallLCN message is received, store the LCN and LCGN 
so that these parameters can be used for additional 
messages relating to that call. 

If an LCN cannot be assigned to the call, you will receive 
an Outgoing Cail Rejected (ReqType = aiCailRej) as the 
only response to the call request. This generally occurs if 
an LCN is not available for the call. The number of LCNs 
available is configurable in the x25_Start function and must 
be the same as the DUT. 

• Your application must cail x25_Receive a second time in 
order to receive a response from the DUT. If an Outgoing 
Call Accepted (ReqType = aiCailAcc) is received, the call 
request was accepted and the call is considered 
established. 
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If you receive an Outgoing Call Rejected 
(ReqType = aiCallReq), the call request was rejected by the 
DUT and the call cannot be established. 

Use the following sequence to handle an incoming call: 

• The application must call the function x25_Receive(). At 
any time this function is called, an incoming call could be 
received. An incoming call request is indicated by the 
receipt of an Incoming Cail (ReqType = aiCailSetup), which 
also includes the LCN assigned to the call. 

• To reject an incoming call, your application must call the 
function x25_ClearReq() for the indicated LCN. 

• There are two methods available for accepting incoming 
call requests. The rnethod used is determined by the 
Answer parameter in the function x25_Start() which was 
called to initialize the X.25 simulator. 

- If Answer is Automatic, incoming cail requests are 
accepted automatically by the simulator; the application 
does not have to transmit a response to the DUT. 

- If Answer, is Manual, your application must call the 
function X25 CallAcc() in order to accept the call for 
the indicatedTCN. 

For SVCs, once the call is established, data can be 
transmitted and received as described below. 


Data Transfer 


During data transfer, the X.25 simulator handles flow control, 
sequence numbering, and error recovery automatically for you. 

• To transmit a Data packet from the Chameleon to the DUT, 
cail the function x25_DataReq(). 

- For PVCs, use the fixed LCN and LCGN corresponding 
to that PVC. 

- For SVCs use the LCN and LCGN received in the 
aiCallLCN message for that call. 

• An Incoming Data packet from the DUT is indicated by the 
receipt of an Incoming Data (ReqType = aiData) in 
response to an x25_Receive(). 
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Call Clearing 

Call Clearing is relevant for SVCs only. 

• To transmit a Clear Request packet from the Chameleon to 
the DUT, call the function x25_ClearReq(). 

• A Clear Request packet from the DUT is indicated by the 
receipt of a Call Cleared (ReqType = aiCailCleared) in 
response to an x25_Receive<). 

If the X.25 simulator has to clear a call (due to protocol 
requirements), it sends a Clear Request both to your X.25 
application and to the DUT. Your application can determine 
whether the Clear Request was initiated by the X.25 simulator 
or by the DUT by checking the RetVal parameter of the 
received aiCailCleared. 


Call Reset 

Call Reset is valid only for PVCs or SVCs in data transfer 

state. 

* To transmit a Reset Request packet from the Chameleon 
to the DUT, cal! the function x25_ResetReq{). 

• An Incoming Reset packet from the DUT is indicated by the 
receipt of an Incoming Reset (ReqType = aiResetLCN) in 
response to an x25_Receive(). 


Interrupt Data 


Interrupt Data is valid only for PVCs or SVCs in data transfer 
state. 

• To transmit an Interrupt Data packet from the Chameleon 
to the DUT, call the function x25 lntDataReq(). This 
function is valid only for PVCs or for SVCs currently in Data 
Transfer state. 

• An Interrupt Data packet from the DUT is indicated by the 
receipt of an Incoming Interrupt Data (ReqType = ailntrupt) 
in response to x25_Receive(). 
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Restart 

• To transmit a Restart Request packet from the Chameleon 
to the DUT, call the function x25_Restart(). A Restart 
affects all active channels. 

• A Restart packet from the DUT is indicated by the receipt 
of an Incoming Restart (ReqType = aiRestart) in response 
to x25_Receive(). 


Diagnostic Packet 

• To transmit a Diagnostic packet from the Chameleon to the 
DUT, call the function x25_DiagReq(). 

• A Diagnostic packet from the DUT is indicated by the 
receipt of an incoming Diagnostic (ReqType = aiD'tag) in 
response to x25_Receive(). 


Stopping the X.25 Simulato r 

You must stop the X.25 simuiator before you exit your 
application. If you use the C function exitQ, this will be done 
automatically for the ports you have initialized. Otherwise, 
your application must call these two functions: 

• x25_Setport() selects the Chameleon port oh which to stop 
the simuiator. 

• x25_Stop{) stops the X.25 simuiator on the selected port. 

To stop the X.25 simulator on both Ports A and B, you must 
call x25_Setport() and then x25_Stop() for each port. 


Tekelec 


3-7 


Version 1.0 





Chameleon 32 X.25/HDLC C Simulation 


X.25 Simulator 


Passing Data The structure ACB (Application Contents Block) is used to 

pass data to X.25 for transmitting and receiving X.25 packets. 
Each function which uses structure ACB describes the 
parameters which are required for that function. 


typedef uch 
typedef uint 
typedef ush 


typedef struct { 
uch 
uch 
uch 
uch 
uch 
uch 
uch 
uch 
uch 
uint 
uch 
uint 
uch 
uch 
uch 
ush. 
uch 
ush 
ush 
int 

} ACB; 


unsigned char; 
unsigned int; 
unsigned short; 

Q Sit; 

D Bit; 

M Bit; 

LCGN; 

LCN; 

*pClgAd; 

*pCidAd; 

FacLen; 

*pFacii; 

RegLen; 

*pReg; 

UD Len; 

"pUserData; 

Cause; 

Diag; 

DiagExpLen; 

*p Diag Exp; 

RetVal; 

ReqType; 

Ref No; 
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x25_CalIAcc 

Declaration 


Description 

Range 


Returns 


#include x25lib.h 

int x25_CallAcc(pACB) 

ACB *pACB; 


This function accepts an incoming Cal! Request from the DUT. 
Structure ACB is defined on page 3-8. 


The structure ACB parameters which are required for this 
function are as follows: 

D Bit 0 = D-bit not set 

1 = D-bit set 

*pClgAd Pointer to Calling DTE Address (maximum 

■of 15 ASCII digits) 

*pCldAd Pointer to Called DTE Address (maximum of 

1 5 ASCII digits) 


FacLen 

*pFacil 

UD__Len 

*pUserData 


Facilities length ■ 
Pointer to Facilities 
User Data length 
Pointer to User Data 


0 Successful 

-1 X.25 simulator is not started 

-3 Queue to the X.25 simulator is full; try again 

-5 Parameter error 
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Sample Program 


usr Cal lAcc() 

{ 

ACB uACB; 

unsigned char facil[109], userData[128]; 
int result; 


facil[C] 
facil[l] ■ 
facil[2] 
user0ata[01 
userData£l] 

uACB.D bit 

uACB.pClgAd 
uACB.pCldAd 
uACB « FacLen 
uACB.pFacil 

uAC3.UD ten 

uACB.pUserOata 

result = x25 

} 


= 0x32; 

= 0x42; 

» 0x5c; 

= 0x01; 

= 0x02; 

= 0 ; 

= *12345*; 

= *67890"; 

« 3; 

= facil; 

= 2 ; 

= userData; 
CallReq(SiuACB); 
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x25_CaIIReq 

Declaration 


Description 


Range 


Returns 


#include x25!ib.h 

int x25_CaIIReq(pACB) 

ACB *pACB; 


This function transmits a Call Request packet from the 
Chameleon to the DUT, it enables the Chameleon to initiate 
call establishment. Structure ACB is defined on page 3-8. 


The parameters in structure ACB required by this function are 
as follows: 

D Bit 0 = D-bit not set 

1 * D-bit set 


*pClgAd 


Pointer to Calling DTE Address (maximum 
15 ASCII digits) • 


*pCldAd 


Pointer to Called DTE Address (maximum 
15 ASCII digits) 


FacLen , 


Facilities length 


*pFacil 


Pointer to Facilities 


UD__Len User Data length 

*pUserData Pointer to User Data 


RefNo Call reference number to identify the call 

request. This parameter enables you to 
match the response from the simulator 
(indicating the assigned LCN) with its 
corresponding Call Request. 


0 Successful 

-1 X.25 simulator is not started 

-3 Queue to X.25 simulator is full; try again 
-5 Parameter error 
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Sample Program 

usr CallReq() 

{ 

ACB uACB; 

unsigned char facil[109], userData[128]; 
int result; 

facil[0] = 0x32; 

faci1[l] = 0x42; 

facil[2] = 0x5c; 

userOata^O] = 0x01; 

userDatafl] * 0x02; 

uACB.D bit = 0; 

uACB.pClgAd = "12345"; 

uACB.pCldAd = "87890";' 

uACB.FacL.en =3; 

uACB.pFacil = facil; 

uACB.UD_Len =2; 

uACB .pUserOata 3 userData; 

uACB.RefNo =11; . /* This number is used to identify the */ 

/* Corresponding Call Accept/Reject */ 
/* The user can select any number */ 

result = x25 CallReq(&uACB); 

Call x25 Receive to get the assigned LCN then *•/ 

/*• Call x25 : Receive to get Call Accept/Call Reject **/ 

/** The Call Accept will contain LCN, ICGN and RefNo **/ 

} 
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x25_ClearReq 

Declaration 


Description 


Range 


Returns 


Sample Program 


#inc!ude x251ib.h 

int x25_ClearReq(pACB) 

ACB *pACB; 


This function transmits a Clear Request packet from the 
Chameleon to the DUT. This function is valid for SVCs only. 
Structure ACB is defined on page 3-8. 


The structure ACB parameters which are required for this 
function are: 


LCGN 


Logical channel group number (0 - 16) 


LCN Logical channel number (0 - 256) 

Cause Cause code 


Diag Diagnostic .code 


0 Successful 

-1 X.25 simulator is not started 

-3 Queue to X.25 simulator is full; try again 
-5 Parameter error • 


usr ClearReq(chan) 

int chan; /• High byte LCGN, low byte LCN */ 

{ 

ACB uACB ; 
int result; 


uACB.LCGN 
uACB.LCN 
uACB. Cause 
uACS.Diag 


= chan>>8; /* Group number received in Call Accept */ 

= chan; /• Channel number received in Call Accept •/ 
= 0*16; 

= 0x11 


result = *25 ClearReq(&uACB); 


} 
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x25_DataReq 

Declaration 


Description 


Range 


Returns 


#inc!ude x25lib.h 

int x25_DataReq(pACB) 

ACB *pACB; 


This function transmits a Data packet from the Chameleon to 
the DUT. Structure ACB is defined on page 3-8. 


The structure 
function are: 

ACB parameters which are required for this 

Q_Bit 

0 = Q-bit not set 
t = Q-bit set 

D Bit 

0 = D-bit not set 

1 = D-bit set 

M_Bit 

0 = M-bit not set 

1 = M-bit set 

LCGN 

'Logical channel group number (0 - 16) 

LCN 

Logical channel number ( 0 - 256) 

UD_Len 

User data length. This specifies the 
maximum allowed length of user data in the 
packet. This, is limited by the value 
specified for MaxFrmSizeNI (HDLC 
maximum frame size) in x25Start(): 


• For Mod 8, UD Len must be < 
MaxFrmSizeNI - 3. 


• For Mod 128, UD Len must be < 
MaxFrmSizeNI - 4. This should be <the 
link level frame size (3 for Mod 8 or 4 for 
Mod 128) 

*pUserData 

Pointer to User Data 


0 Successful 

-1 X.25 simulator is not started 

-3 Queue to X:25 simulator is full; try again 
-5 Parameter error 
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Sample Program 

usr DataReq(chan,data,dLen) 

int chan; /* High byte LCGN, low byte LCN •/ 

unsigned char *data; 
int dLen; 

{ 

ACS uACB; 
int result; 

uACB.LCGN = chan>>8; /* Group number received in Call Accept */ 
uACB.LCN = chan; /* Channel number received in Call Accept */ 

uACB.Q_ Bit = 0; 

uAC8.D_Bit = 0; 

uACB.M Bit * 0; 

uACB.dLen = dL-en; 

uACB.pUserData = data; 

result = x25 DataRea(&uACB); 

/* Call x25 Receive to check if Clear/Restart has been received. */ 

} 
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Declaration #include x251ib.h 

int x25 DiagReq(pACB) 
ACB *pACB; 


Description This function transmits a Diagnostic packet from the 

Chameleon to the DUT. Structure ACB is defined on page 3- 

8 . 


Range The structure ACB parameters which are required for this 

function are as follows: 

Diag Diagnostic code 

DiagExpLen Diagnostic Explanation Length 

‘pDiagExp Pointer to Diagnostic Explanation 


Returns 0 Successful 

-1 X.25 simulator is not started 

-3 Queue to X.25 simulator is full; try again 
-5 Parameter error 


Sample Program 

usr DiagReqO- 
{ 

ACB uACB; 

unsigned char diagExp[3Z] ; 
int result; 

diagExp[0] = 0x31; 

uACS.Dlag = 0x72; 

uACB. DiagExpLen * 1; 

uACB .pfliagExp =■ diagExp; 

result = x25 DiagReq(&uAC3); 
} ' 
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x25_Getport() 

Declaration 


Description 


Returns 


#include x251ib.h 
int x25_Getport() 


This function returns the port which is currently selected. (The 
SelectPort() function enables you to select a port.) This 
function is used on Dual Port machines when the X.25 
simulator is initialized on both ports. 


0 = Port A is active 

1 = Port B is active 
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x25JntDataReq 

Declaration #include x25iib.h 

int x25_JntDataReq(pACB) 

ACB *pACB; 

Description This function transmits an Interrupt Data packet from the 

Chameleon to the DUT. Structure ACB is defined on page 3- 

8 . 

Range The structure ACB parameters which are required for this 

function are as follows: 

LCGN Logical channel group number (0-16) 

LCN Logical channel number (0 - 256) 

UD_Len User Data length 

*pUserData Pointer to User Data 

Returns 0 Successful 

-1 X.25 simulator is not started 

-3 Queue to X.25 simulator is full; try again 
-5 Parameter error 

Sample Program usr IntDataReq(chan .data, dLen) 

int Chan; ' /• High byte LCGN, low- byte LCN V 

unsigned char *data; 
int dLen; 

{ 

ACB uACB; 
int result; 

uACB.LCGN = chan>>8; /* Group number received in Call Accept */ 

uACB.LCN * chan; /* Channel number received in Call Accept V 

uACB.dLen ' = dLen; 

uACB .pUserData - data; 

result = x25 IntDataReq{&uACB) ; 

/** Call x25 Receive to check if Clear/Restart has been received. */ 

> 
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x25_LinkReq 

Declaration 


Description 

Range 


Returns 


Sample Program 


#include x251ib.h 

int x25_LinkReq(type,waitTime) 
int type; 
int waitTime; 


This function causes the Chameleon to initiate link 
establishment or disestablishment by setting the link on or off. 


type 0 = Set Link OFF 

1 = Set Link ON 

int waitTime Time to wait for the link to be set on or off, 
in the range 0 - 250 seconds 


0' Successful 

-1 X.25 simulator is not started 

-3 Queue to X.25 simulator is full; try again 
-5 Parameter error 

-8 Link not established within specified time 


usr LinkONQ 

{ 

int ret; 

y* Set link on, wait max 30 seconds for link */ 

if ( (ret = x25 LinkReq(l,30)) ) printf { "Link on failed\n"); 

else printf("Link establ ishedVn” ) ; 

return( ret ); 

> 
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x25_Receive 

Declaration 


Description 


Range 


#inc!ude x25lib.h 
#include mtosux.h 

int x25_Receive(pACB, waitTime) 
long waitTime; 

ACB *pACB; 


This function enables the Chameleon to receive data from the 
DUT or the X.25 simulator into a structure of type ACB 
(defined on page 3-8). This function should be called after 
each call to a request procedure in order to get information 
about incoming Clear, Restart and Link Status packets. 

Structure ACB includes parameters which are pointers to 
buffers to be used for the data received by the Chameleon. 
The buffers must be initiated by the application program so 
that data can be copied to them. The alternative is to use 
NULL, in which case no data will be copied. These 
techniques are illustrated in the sample program. 


waitTime The time to wait for a response, as follows: 

SEC + t Time in seconds 

HMS+t Time in .01 seconds 

TMS + 1 Time in .001 seconds 

MS+t Time in .0001 seconds 

NOEND Wait forever 

1MONLY Attempt to receive one time only 

Do not use a waitTime < .0010 seconds. 


The structure ACB parameters which are set by this function 
depend on the type of packet received from the DUT. The 
ReqType parameter is set in structure ACB for all received 
packets, as defined below. 


ReqType Specifies the type of X.25 packet received from 
the DUT or the X.25 simulator. The return values 
for ReqType and the constants defined in x25lib.h 
for those values are shown in the table on the 
next page. 
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ReqType 

Return Value (Decimal) 

CONSTANT DEFINED IN 
x25lib.h 

X.25 PACKET 

61 

aiCallSetup 

Incoming Call 

62 

aiCallRej 

Outgoing Call Rejected 

63 

aiCal [Cleared 

Cal! Cleared 

64 . 

aiData 

Incoming Data 

65 

aiResetLCN 

Incoming Reset 

67 

ai Restart 

Incoming Restart Request or 
Restart Confirmation or Timeout 

68 

aiCallAcc 

Outgoing Call Accepted 

70 

aiDiag 

Incoming Diagnostic 

71 

ailntrupt 

Incoming Interrupt Data 

72 

aiUnk 

Link Status 

73 

aiCallLCN . 

Assigned LCN 

.74 

aiRegister 

Incoming Register 


ReqType Parameter Values (ACB Structure) 


Once you identify the type of X.25 packet received, you can 
further examine the contents of the received packet by 
determining the values of the relevant parameters in structure 
ACB. For each X.25 packet type, the relevant ACB 
parameters are listed on the following pages. 
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ReqType = 61 
aiCallSetup 
(Incoming Call) 


ReqType = 62 
aiCallRej 
(Outgoing Call 
Reject) 


This message indicates an incoming Call Request from the 
DUT. The following parameters are set in structure ACB for 
aiCallSetup: 


D Bit 

0 = D-bit not set 
t = D-bit set 

LCGN 

Logical channel group number (0-16) 

LCN 

Logical channel number (0 - 256) 

*pClgAd 

Pointer to Calling DTE Address 
(maximum 15 ASCII digits) 

*pCldAd 

Pointer to Called DTE Address 
(maximum 15 ASCII digits) 

FacLen 

Facilities length (0 - 1 09) 

*pFaciI 

Pointer to Facilities 

UD_Len 

User Data length (0 - 128 bytes) 

‘pUserData 

' Pointer to User Data 

RetVal 

Always zero 


This is one of the possible second messages received in 
response to an x25_^CallReq and indicates that the Call 
Request is being rejected by the DUT. The following 
parameters are set in structure ACB for aiCallRej: 


LCGN 

Logical channel group number (0-16) 

LCN 

Logical channel number (0 - 256) 

FacLen 

Facilities length (0 - 1 09) 

*pFacii 

Pointer to Facilities 

UD_Len 

User Data length (0-128 bytes) 

’pUserData 

• Pointer to User Data 

Cause 

Cause code 
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ReqType = 63 
aiCallCleared 
(Call Cleared) 


Diag Diagnostic code 

RetVal 1 = Timeout 

3 = Call collision 

4 = Call rejected by DUT 

7 = No more LCNs available 

RefNo Reference number corresponding to the 

Cail Request when RetVal = 7(No more 

LCNs available). This value enables you 
to match the aiCallRej to its 
corresponding Cal! Request when 
multiple cails have been requested. 


This message indicates that a Call Cleared was received from 
the DUT or the X.25 simulator. The following parameters are 
set in structure ACB for aiCallCleared: 


LCGN 

Logical channel group number (0-16) 

LCN 

' Logical channel number (0 - 256) 

FacLen 

Facilities length (0 - 1 09) 

*pFacil 

Pointer to Facilities 

UD_Len 

User Data length (0 - 128) 

*pUserData 

Pointer to User Data 

Cause 

Cause code 

Diag 

Diagnostic code 

RetVal 

0 = Incoming Clear (from DUT) 

2 = Internal Clear (from X.25 simulator) 
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ReqType = 64 
aiData 

(Incoming Data) 


ReqType = 65 
aiResetLCN 
(Incoming Reset) 


This message indicates that a Data packet was received from 
the DUT. The following parameters are set in structure ACB 
for aiData: 


Q_Bit 

0 = Q-bit not set 

1 = Q-bit set 

D Bit 

0 = D-bit not set 

1 = D-bit set 

M_Bit 

0 = M-bit not set 

1 = M-bit set 

LCGN 

Logical channel group number (0-16) 

LCN 

Logical channel number (0 - 256) 

UD_Len 

User Data length. The range is 0-8192 
bytes, but is -limited by the maximum 
packet size and frame size specified 
when the simulator was initialized using 
x25 Start(). 

‘pUserData 

Pointer to User Data 

RetVal 

Always zero 


This message indicates that a Reset packet has been 
received from the DUT. (The channel has been reset, but the 
call is still active.) The following parameters are set in 
structure ACB for aiResetLCN: 


LCGN 

Logical channel group number (0 - 

LCN 

Logical channel number (0 - 256) 

Cause 

Cause code 

Diag 

Diagnostic code 

RetVal 

Always zero 
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Reqtype = 67 
ai Restart 
(Incoming Restart 
Request/Restart 
Confirmation/ 

Timeout) This message indicates that a Restart packet has been 

received from the DUT. (Ail SVC calls have been cleared and 
all PVCs has been reset.) The following parameters are set in 
structure ACB for ai Restart: 



Cause 

Cause code 


Diag 

Diagnostic code 


RetVai 

1 = Timeout 

2 = Internal Restart 

5 = Restart Confirm 

6 = Incoming Restart 

Reqtype = 68 
aiCallAcc 



(Outgoing Call 
Accepted) 




This is one of the possible second messages received in 
response to an x25_CailReq and indicates that the Call 
Request is being accepted by the . DUT. The following 
parameters are set in structure ACB for aiCallAcc: 


D Bit 

0 = D-bit not set 


1 = D-bit set 

LCGN 

Logical channel group number (0-16) 

LCN 

Logical channel number (0 - 256) 

"pCIgAd 

Pointer to Calling DTE Address 
(maximum 15 ASCII digits) 

*pCldAd 

Pointer to Called DTE- Address 
(maximum 15 ASCII digits) 

FacLen 

Facilities length (0 - 1 09) 

*pFacil 

Pointer to Facilities 

UD_Len 

User Data length (0-128 bytes) 

*pUserData 

Pointer to User Data 

RetVai 

Always zero 
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ReqType = 70 

aiDiag 

(Incoming 

Diagnostic) This message indicates that a Diagnostic packet has been 

received from the DUT. The following parameters are set in 
structure ACB for aiDiag: 



Diag 

Diagnostic code 


DiagExpLen 

Diagnostic Explanation Length (0 - 3) 


*pDiagExp 

Diagnostic Explanation 


RetVal 

Always zero 

ReqType =71 
ailntrupt 
(incoming 
Interrupt Data) 

This message indicates that an Interrupt packet has been 
received from the DUT. The following parameters are set in 
structure ACB for ailntrupt: 


LCGN 

Logical channel group number (0-16) 


LCN 

Logical channel number (0 - 256) 


UD_Len 

User Data length 


*pUserData 

Pointer to User Data (0 - 32) 


RetVal 

Always zero 


ReqType = 72 
aiLink 

(Link Status) This message indicates that a change in link status packet has 

been received from the DUT. The following parameters are 
set in structure ACB for aiLink: 

RetVal 9 = Link Up 

8 = Link Down 
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ReqType = 73 
aiCallLCN 
(Assigned LCN) 


ReqType = 74 
aiRegister 
(Incoming 
Register). 


This message is received from the X.25 simulator as a 
response to an x25_CallReq(). It indicates the LCN that will 
be assigned to the call. All subsequent packets for the call 
should have the LCN and LCGN set using the indicated 
values. The following parameters are set in structure ACB for 
aiCallLCN: 


LCGN 

Logical channel group number (0-16) 

LCN 

Logical channel number (0 - 256) 

RetVal 

Always zero 

RefNo 

Reference number corresponding to . the 
Call Request. This value enables you to 
match the LCN to the appropriate Call 
Request when multiple calls have been 
requested. 


This message indicates that a Registration packet has been 
received from the DUT. The following parameters are set in 
structure ACB for aiRegister: 


*pClgAd 

Pointer to Calling DTE Address 
(maximum 15 ASCII digits) 

*pCldAd 

Pointer to Called DTE Address 
(maximum 15 ASCII digits) 

RegLen 

Registration length (0 - 1 09) 

*pReg 

Pointer to Registration 

RetVal 

Always zero 
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Sample Program 


usr Receive( ) 

{ 


ACB uACB; 
unsigned char 
unsigned char 
unsigned char 
unsigned char 
unsigned char 
unsigned char 
int result; 


dgAd[16]; 

cldAd[16]; 

faciliog]; 

u0ata[5l2]; 

Reg[109]; 

diagExp[3] ; 


uACB.pClgAd 
uACB.pddAd 
uACB.pfacil 
uACB .pUserData 
uACB . pReg 
uACB , pDiagExp 


= clgAd; 

= cldAd; 

= facil ; 

= uOata; 

= reg; 

= diagExp; 


/* Max address length + 1 for string terminator •/ 
/• Max address length + 1 for string terminator */ 


/* Max facility length •/ 
/* Should he set to max packet siae •/ 
/* Max registration length */ 
/* Max diagnostic explanation length •/ 

/* Parameters are copied to these buffers •/ 
/* If we are not interested in a parameter */ 
/* replace the buffer name with OL */ 
/* uACB. pUserData = OL; */ 
/* In this case, no buffer space has to be •/ 
/* reserved */ 


result = x25 Recei veReq(&uACB, 1+HMS) ; 

switch (uACB.ReqType) 

{ 


case 

aiCallSetup: 

handle inc call (SuACB) ; 

break; 

case 

aiCal 1 Rej : 

handle calibre j (&uACB) ; 

break; 

case 

aiCallCleared-.handle call clear(&uACB.) 
break; 

case 

a i Data: 

handle data(SuACB); 
break; 

case 

aiResetLCN : 

handle reset(SuACB) ; 
break; 

case 

aiRestart: 

handle restart(&uACB) ; 
break; 

case 

aiCallAcc: 

handle call acc(&uACB); 
break; 

case 

aiDiag: 

handle diagnos(SuACB) ; 
break; 

case 

ailntrupt: 

handle interupt{&uACB) ; 
break; 

case 

aiRegister : 

handle register(&uACB) ; 
break; 

case 

ailink: . 

handle 1 ink(SuACB) ; 
break; 

case 

aiCallLCN: 

handle LCN(&uACB); 
break; 

default: 

} 

break; 
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x25_ResetReq 


Declaration #inciude x25lib.h 

int x25_ResetReq(pACB) 
ACB *pACB; 


Description This function transmits a Reset Request packet from the 

Chameleon to the DUT. Structure ACB is defined on page 3- 

8 . 


Range 


The structure ACB parameters required for this function are as 


follows: 


LCGN 

Logical channel group number (0 

LCN 

Logical channel number (0 - 256) 

Cause 

Cause code 

Diag 

Diagnostic code 


Returns 


0 Successfui 

-1 X.25 simulator is not started 

-3 Queue to X.25 simulator is full; try again 
-5 Parameter error 


Sample Program usr ResetReq{ chan) 

int chan; /* High byte LCGN, low byte LCN */ 


ACB uACB; 
int result; 


uACB. LCGN 
uACB.LCN 
uACB .Cause 
uACB .Diag 

= chan>>8; /* Group number received in Call Accept */ 
= chan; /* Channel number received in Call Accept V 
= 0x16; 

= 0x72; 

result - x25 

ResetReq(SuACB) ; 


} 
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x25_RestartReq 


Declaration #include x251ib.h 

int x25_RestartReq(pACB) 
ACB *pACB; 


Description This function transmits a Restart Request from the Chameleon 

to the DUT. A restart affects the state of ail LCNs. The 
procedure will not return until the DUT has responded or timer 
T10 has timed out (60 seconds). Structure ACB is defined on 
page 3-8. 


Range The structure ACB parameters which are required by this 

function are as follows: 

Cause Cause code 

Diag Diagnostic code 


Returns 0 

1 “1 
-3 
-4 
-5 
-6 


Sample Program 

usr RestartReq{ ) 

{ 

ACB uACB; 
int result; 

uACB. Cause * 0x16; 

uACB.Diag = 0x72; 

result * x25 RestartReq(SuACB) ; 

} 


Successful 

X.25 simulator is not started 
Queue to X.25 simulator is full; try again 
Timeout, no data received 
Parameter error 

No answer from Device Under Test 
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x25_Setport 


Declaration 


Range 

Description 


Returns 


#include x251ib.h 
int x25_Setport(port) 
int port; 


port 0 = Port A 
1 = Port B 


This function, selects a port when the X.25 simulator is 
initialized on both ports. If x25 Setport is not used in- the 
application program, the default is~Port A. 


0 Successful 
-5 Parameter error 
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x25__Start 

Declaration 


Description 


Range 


#inciude x25lib.h 

int x25_Start(pLPB) 

LPB *pLPB; 


This function initializes the X.25 simulator on the selected port 
using the HDLC and X.25 parameters specified in the structure 
LPB. The structure LPB (Link Parameter Block) is as follows: 

typedef struct { 


ulong 

Baud; 

uch 

Encoding; 

uch 

DC_TE; 

uch 

. Net_Sub; 


Interface; 

int 

ReTxN2; 

uch 

Tl; 

int 

Port; 

uch 

PackWin; 

uch 

LinkWin; 

int 

MaxFrmSizeNI 

uch 

ModVal; 

ush 

No of SVCs: 

ush 

No of PVCs; 

uch 

Standard; 

int 

Answer; 


} LPB; 


The parameters are as follows: 

HDLC Parameters 

Baud Specifies the bitrate when a V-type interface 

is being used and the Chameleon is acting 
as the DCE. The valid range is 50 - 64000 
bps. 

Encoding Specifies the encoding scheme to use: 

0 = NR2 

1 = NRZI 
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Net_Sub Specifies whether the Chameleon is 

simulating a Network or Subscriber 

0 = Network 

1 = Subscriber 


Interface 


Specifies the physical interface that will be 
used: 


0 = DCE (V-type) 

1 = DTE (V-type) 

3 = ISDN (BRI or PRI) 

MaxFrmSizeNI Specifies the value of N1 (maximum frame 
size) in the range 1-512 bytes 


ReTxN2 


UnkWin 


T1 

Port 


Specifies the value of N2 in the range 1 - 255 

For modulo 8, this specifies the window size 
in the range 1 - 7 . 

Specifies the value of T1 in the range 1 - 255 

This parameter is used internally. It is 
automatically set to the port selected with 
x25_Setport(port). . 


X.25 Parameters 

DC_TE . Specifies whether the Chameleon is 

simulating a DCE or DTE device: 

0 = DCE 

1 = DTE 

PackWin Specifies the packet window size: 

Mod 8 1-7 

Mod 128 1-127 

MaxPackSize Specifies the maximum allowed length of 
user data in a Data packet. This is limited by 
the value selected for HD'LC N1 
(MaxFrmSizeNI): 

• For Mod 8, MaxPackSize must be < 
MaxFrmSizeNI - 3. 

• For Mod 128, MaxPackSize must be < 
MaxFrmSizeNI - 4. 
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ModVal Specifies the modulo: 

0 = Modulo 8 

1 = Modulo 128 

No_of_SVCs Specifies the number of SVCs that can be 
used in the simulation session- This value 
must match the number of SVCs supported 
on the DUT. The valid range is 0 - 4095. 
(No_of_SVCs + No_of_PVCs < = 4095) 

No_of_PVCs Specifies the number of PVCs that can be 
used in the simulation session. This value 
must match the number of PVCs supported 
on the DUT. The valid range is 0 - 4095. 
(No_of_SVCs + No_of_PVCs < = 4095) 

LCNs are assigned automatically to PVCs, 
beginning with the lowest LCN. If the X.25 
standard is CCiTT, the first PVC will be 
assigned to LCN 1. if the X.25 standard is 
TRANSPAC, the first PVC will be assigned to 
LCN 0. 

Standard Specifies the X.25 standard being used: 

0 = CCITT X.25 standard 

1 = TRANSPAC X.25 standard 

Answer Specifies how the X.25 simulator will act 

when an incoming Cali Request is received 
from the DUT. 

0 = ' Automatic. All incoming Call Requests 

are accepted automatically by the 
simulator. 

1 = Manual. The application must call 

x25_CailAcc to accept the Call 
Request or x25_ClearReq to reject the 
Call Request. 


Returns 0 Successful 

-1 X.25 simulator is not started 

-2 X.25 simulator is already started 

-3 Queue to X.25 simulator is full; try again 

-4 Timeout, no data received 

-5 Parameter error 

-6 No answer from Device Under Test 

-8 Link not established within specified time 
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Sample Program 

usr x25Start( ) 

{ 

, LC8 vLCB ; 
int result; 

vLPB.ModVal 

vLPB.PackWin 

vLPB.LinkWin 

vLPB.MaxFrmSizeNl 

vLPS.No of_SVCs 

vLPB .No of PVCs 

' ' vLPB.DC TE 

vLPB. Baud 
vLPB. Encoding 

vLPB.Net Sub 

vLPB.ReTxN2 
vLPB.Tl 
vLPB. Port 
vLPB. Standard 
vLPB .Answer 


i 


= MODS; /* Constants are defined ix x251ib.h •/ 
= 2 ; 

= 7;. 

= 512; 

= 7; 

= 2 ; 

= DTE ; 

= 9600L; 

= NRZ; 

= NETWORK; 

*7; 

= 3; 

= PORTA; 

= CCITT; 

= AUTO_ANS; 


result = x25_Start(SvLCB); 

} 
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x25_Stop 

Declaration 


Description 


Note 


Returns 


#inc!ude x25lib.h 
int x25__Stop() 


This function stops the X.25 simulator on the selected port. 
Your application must stop the X.25 simulator on all ports 
before the application is exited. 

To stop the X.25 simulator on both Ports A and B, you must 
call x25_Setport() and then x25_Stop{) for each port. 

If your application calls the C exit() function, this function is 
called automatically for. the ports you have initialized. 


0 Successful 
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